lcDrwAddImage2 Home

Adds a new raster image into a drawing. The image will be created programmatically instead of loading from a file.

 HANDLE lcDrwAddImage2 (
   HANDLE hDrw,
   LPCWSTR szName,
   int Width,
   int Height,
   int ColorDepth,
   HANDLE hData,
   BOOL bTopDown
 );

Parameters
hDrw
  Handle to a drawing object.
szName
  Image name. Must be different from exist images names.
Width Height
  Image width and height, pixels.
ColorDepth
  A number of bits per pixel. The value can be 1, 4, 8 for index color bitmap, and 24, 32 for true color bitmap.
hData
  Pointer to a memory buffer which contains bitmap pixels data. RGB color for ColorDepth = 24 or 32, or palette indices for ColorDepth = 1,4,8
bTopDown
  Defines how bitmap lines are placed in the hData array:
True - from top to bottom and its origin is the upper-left corner
False - from bottom to top and its origin is the lower-left corner

Return Value

  Handle to a new raster image.
If the function fails, the return value is NULL.

See Also

  Code sample 1,   Code sample 2,   Image reference,   lcBlockAddImageRef